home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / lan / scands.zip / README.TXT < prev    next >
Text File  |  1996-01-05  |  13KB  |  320 lines
  1. The following files are included in SCANDS.EXE:
  2.      LETTER.TXT     2,051 Bytes
  3.      README.TXT     12,809 Bytes
  4.      SCANTREE.EXE   202,062 Bytes
  5.      SMEM.EXE       56,077 Bytes
  6.      SURVEY.TXT     5,329 Bytes
  7.  
  8. README.TXT
  9.  
  10. Using SCANTREE.EXE to Gather NDS Tree Statistics
  11.  
  12. This DOS text file is from an AppNote in the January 96 issue
  13. of the Novell Application Notes. For subscription information,
  14. call the Novell Research Order Desk :
  15.      800-377-4136 (U.S. & Canada)
  16.      303-297-2725 (other locations)
  17.      303-294-0930 (fax)
  18.  
  19.  
  20. Table of Contents
  21.  
  22. Abstract
  23. Purpose
  24. Introduction to SCANTREE
  25. System Requirements
  26. SCANTREE Syntax
  27. Use of Options
  28. Handling Error Conditions
  29. Estimated Time to Completion
  30. Sample Log Files
  31.  
  32.  
  33. Abstract
  34. SCANTREE.EXE is a DOS application designed to traverse an NDS tree
  35. and return a series of statistics. The results help to characterize an NDS
  36. tree by describing the width and depth of the tree, as well as the variety
  37. and characteristics of leaf objects. This document describes how to run
  38. SCANTREE. It covers the system requirements, explains the command
  39. syntax, and shows some sample log files.
  40.  
  41.  
  42. Purpose
  43.                       
  44. The release of SCANTREE.EXE is part of an ongoing
  45. research project performed by Novell Systems Research
  46. and we invite you to participate. You can help by filling out
  47. a site survey, running SCANTREE.EXE, and returning the
  48. survey and SCANTREE log file to rlee@novell.com.
  49.                       
  50. The site survey, SCANTREE.EXE, SCANTREE
  51. documentation, and your invitation to participate are
  52. enclosed in a self-extracting file called SCANDS.EXE.
  53. This file can be found on NetWire, ftp, and ftp via
  54. www.novell.com.
  55.                       
  56. The purpose of this study is to accumulate enough data
  57.  about customers' trees of all sizes so that we can
  58. statistically describe trees being used in production
  59. networks. This data will benefit the design of NDS
  60. benchmarks and the formulation of rules of thumb for
  61. NDS design and optimization.
  62.                       
  63. If you need further information concerning the project and
  64. how you can participate, send a request for information to
  65. rlee@novell.com with a subject of "Scantree RFI."
  66.  
  67.  
  68. Introduction to SCANTREE
  69.  
  70. SCANTREE is a DOS application designed to traverse an NDS tree and
  71. return a series of statistics. The results help to characterize an NDS tree
  72. by describing the width and depth of the tree as well as the variety and
  73. characteristics of leaf objects.
  74.                       
  75. SCANTREE is a read-only application. It will not affect your tree's
  76. structure or data in any way.
  77.  
  78.                       
  79. System Requirements
  80.  
  81. To run SCANTREE.EXE, you need the following:
  82.                       
  83. A personal computer with a 386 or higher processor, running DOS 5
  84.             or higher.
  85. 500 KB of available conventional RAM. (SCANTREE uses
  86.      temporary files such as SCANTREE.nnn to store container
  87.       information. These files reduce the possibility of running out of
  88.      memory while analyzing large trees.)
  89. The Novell VLM client, version 1.20 revision B or higher.
  90. A search drive mapped to the SYS:\PUBLIC\NLS directory.
  91.                       
  92. The SCANTREE workstation connection must be logged in and
  93. authenticated with all read rights to the tree or subtree you are scanning.
  94. This requires you to log in as Admin or some other user with equivalent
  95. access rights before running SCANTREE.
  96.  
  97.                       
  98. SCANTREE Syntax
  99.  
  100. The syntax for running the SCANTREE application is as follows:
  101.                       
  102. SCANTREE [options...]
  103.                       
  104. The options can include any of the following:
  105.                       
  106. /?         Displays the help screen
  107. <context>  Targets a specific context (in typeful format)
  108. /users     Reports only user objects
  109. /d         Dumps all object and container names to standard output
  110.                       
  111. Multiple options may be included on the command line.
  112.  
  113.                       
  114. Use of Options
  115.  
  116. Default Operation.  If you run SCANTREE without any options, the
  117. utility scans all objects in the tree beginning at [Root]. Once finished,
  118. SCANTREE displays its summary statistics to standard output (the
  119. screen).
  120.                       
  121. Example:
  122.                       
  123. SCANTREE
  124.                       
  125. scans the entire tree and outputs statistics to the screen.
  126.                       
  127. Redirection of Standard Output.  In most cases, you'll want to
  128. redirect SCANTREE's output to a file on a local hard drive by using the
  129. ">" operator. When SCANTREE output is redirected, nothing is
  130. displayed on the screen except a busy indicator to provide assurance
  131. that SCANTREE is running.
  132.                       
  133. Example:
  134.                       
  135. SCANTREE > LOG.TXT
  136.                       
  137. scans the entire tree and outputs statistics to the specified file
  138. (LOG.TXT in this example).
  139.                       
  140. Target Context.  If you want to scan a specific context, include the
  141. fully distinguished (typeful) name of the container object on the
  142. command line.
  143.                       
  144. Example:
  145.                       
  146. SCANTREE OU=MKTG.OU=NPD.O=NOVELL > LOG.TXT
  147.                       
  148. scans the specified context (subtree) and outputs results to LOG.TXT.
  149.                       
  150. Report Only User Objects.  Add the command line parameter
  151. /users to scan the tree specifically for user objects and produce
  152. summary statistics related only to user objects.
  153.                       
  154. Example:
  155.                       
  156. SCANTREE /USERS > LOG.TXT
  157.                       
  158. scans the entire tree for user objects and outputs statistics to LOG.TXT.
  159.                       
  160. Dump Object Names.  If the tree structure and object names are
  161. desired, use the /d parameter to dump the structure and object names to
  162. standard output.
  163.                       
  164. Example:
  165.                       
  166. SCANTREE /D OU=MKTG.OU=NPD.O=NOVELL > LOG.TXT
  167.                       
  168. scans the specified context (subtree) and outputs summary statistics,
  169. tree structure and object names to LOG.TXT.
  170.  
  171.                       
  172. Handling Error Conditions
  173. SCANTREE will stop in the case of temporary unavailability of part of
  174. the tree. If this occurs, rerun SCANTREE.
  175.                       
  176. If you receive an "Abort, Retry, Ignore" message from the network,
  177. choose Retry.
  178.  
  179.  
  180. Estimated Time to Completion
  181.  
  182. SCANTREE's execution time depends mostly on the size and
  183. distributed nature of the tree. Small trees can be traversed in several
  184. minutes. Larger trees may take much longer to scan.
  185.                       
  186. For example, Novell's production tree includes 19,000 objects spread
  187. over 300 partitions. SCANTREE required nearly eight hours to traverse
  188. Novell's tree and record the log file statistics. On a weekend, with
  189. minimal network traffic and server utilization, the SCANTREE
  190. operation at Novell completed in half that time. For this example run,
  191. we used the non-default /d parameter to print the tree structure and
  192. object names. A default SCANTREE operation will take less time.
  193.                       
  194. For larger trees, we recommend that you run SCANTREE during an
  195. evening or weekend when the tree traversal can complete more quickly.
  196. Running SCANTREE during periods of low activity allows the tree
  197. traversal to conclude more quickly and keeps unnecessary traffic off the
  198. network and partitions during production hours.
  199.                       
  200.                       
  201. Sample Log Files
  202.  
  203. Following are three sample log files that show the type of data collected
  204. by SCANTREE. Figure 1 shows the results of running SCANTREE on a
  205. newly-installed tree with one server. Since the /d option was used, the
  206. full object and container names are included in the log file. Figure 2
  207. shows the results of running SCANTREE in default mode on Novell's
  208. production tree. Figure 3 is an example of using the /users option to
  209. restrict the results to just User objects.
  210.                       
  211.                       
  212. Figure 1: SCANTREE results from a newly-created tree.
  213.                       
  214.                       
  215. SCANTREE /D > LOG.TXT
  216.  
  217. Scantree O=SNOWBIRD., Mon Dec 11 14:53:59 1995
  218. ==========================================================
  219. OBJECT NAME (SUBORDINATES, ATTRIBUTES, ATTRIBUTE SIZE)
  220. CN=SNOWBIRD (0, 9, 681)
  221. CN=Admin (0, 10, 1104)
  222. CN=SNOWBIRD_SYS (0, 6, 272)
  223. ============== 00:00:00 ==================================
  224. NCP Server                      1
  225. User                            1
  226. Volume                          1
  227. { Attributes - # }              25
  228. { Attributes - size }           2057
  229. { Largest container }           3
  230. { Replicas - Master }         1
  231. { Objects }                     3
  232. { Partitions }      1
  233. { Streams - size }              0
  234.  
  235. Figure 2: SCANTREE results on the Novell production tree.
  236.                       
  237.  
  238.           SCANTREE > LOG.TXT
  239.  
  240.                Scantree [Root], Wed Oct 04 11:18:31 1995
  241.                ==========================================================
  242.                OBJECT NAME (SUBORDINATES, ATTRIBUTES, ATTRIBUTE SIZE)
  243.                O=Novell. (66, 40, 46203)
  244.                ...
  245.                ============== 07:24:05 ==================================
  246.                AFP Server                      1            //Object classes found
  247.                Alias                           375
  248.                Application (DOS)               7
  249.                Application (Windows 3.x)       90
  250.                Application (Windows 95)        7
  251.                Application (Windows NT)        14
  252.                Bindery Object                  510
  253.                Bindery Queue                   124
  254.                Btrieve Server                  1
  255.                Computer                        18
  256.                Connect Server                  21
  257.                Directory Map                   174
  258.                External Entity                 2
  259.                Group                           2501
  260.                Job Queue                       2
  261.                Job Server                      2
  262.                Message Routing Group           1
  263.                Messaging Server                2
  264.                NCP Server                      433
  265.                Organization                    1
  266.                Organizational Role             297
  267.                Organizational Unit             1149
  268.                PBX Device                      97
  269.                PBX Device Group                10
  270.                Palindro:JobQueue               6
  271.                Print Server                    513
  272.                Printer                         454
  273.                Profile                         204
  274.                Queue                           812
  275.                Tserver                         3
  276.                Tserver PBX                     2
  277.                Tserver Service                 11
  278.                Unknown                         68
  279.                User                            9820
  280.                Volume                          1168
  281.                Worktop                         74
  282.                { Attributes - # }              346618       // Summary Statistics
  283.                { Attributes - size }           73383820
  284.                { Collision renames }           73
  285.                { Group memberships }           63057
  286.                { Largest container }           914
  287.                { NWDSList errors }             2
  288.                { NWDSRead errors }             14
  289.                { Objects }                     18974
  290.                { Partitions }                  291
  291.                { Streams - # }                 7452
  292.                { Streams - size }              8311001
  293.                { Subordinate errors }          7
  294.  
  295. Figure 3: SCANTREE results on the Novell production tree with the
  296.                       /USERS option enabled.
  297.  
  298.  
  299.           SCANTREE /USERS > LOG.TXT
  300.           
  301.                Scantree [Root], Thu Oct 05 10:20:03 1995
  302.                ==========================================================
  303.                OBJECT NAME (SUBORDINATES, ATTRIBUTES, ATTRIBUTE SIZE)
  304.                O=Novell. (66, 0, 0)
  305.                ...
  306.                ============== 04:58:56 ==================================
  307.                User                            9826
  308.                { Attributes - # }              264007       // Summary Statistics
  309.                { Attributes - size }           35040525
  310.                { Collision renames }           74
  311.                { Group memberships }           62468
  312.                { Largest container }           916
  313.                { NWDSList errors }             4
  314.                { NWDSRead errors }             2
  315.                { Objects }                     9826
  316.                { Partitions }                  290
  317.                { Streams - # }                 6734
  318.                { Streams - size }              5969009
  319.                { Subordinate errors }          6
  320. END